DXCore API： 地理資訊系統

一、概述

本地理資訊系統模組提供了一個核心功能，旨在將地址字串轉換為其對應的地理座標（緯度與經度）。

此模組透過存取 Google Maps 服務來解析地址資料。它接收一個地址陣列，並為每個地址查詢其精確的地理位置，最後回傳一個包含原始地址與其座標的字串陣列。這對於需要在地圖上標示位置或進行地理空間分析的應用程式非常有用。

二、屬性

此模組沒有可直接存取的屬性。

三、方法

地址轉座標(addresses)

將一個或多個地址轉換為地理座標（緯度與經度）。

描述

此函式接受一組地址，透過 Google Maps 的地址查詢功能獲取其地理座標 (緯度和經度)。每個地址會被轉換成對應的 URL，從 Google Maps 獲取內部 HTML 內容，並通過正則表達 (Regex) 解析緯度與經度數據，然後返回結果陣列。

語法

地址轉座標(addresses)

參數

• addresses (Array): 一個包含地址的字串陣列。

回傳值

(Array): 返回一個字串陣列，其中每個條目包括地址與其對應的緯度與經度，格式為 地址,緯度,經度。

範例

import gis from './地理資訊系統.js';

// 範例 1: 單一地址查詢
const addresses = ['台北 101', '台中車站'];
const results = gis.地址轉座標(addresses);
console.log(results);
// 可能輸出:
// [
//   '台北 101,25.0339639,121.5644722',
//   '台中車站,24.136829,120.685031'
// ]

// 範例 2: 空地址陣列
const emptyAddresses = [];
const emptyResults = gis.地址轉座標(emptyAddresses);
console.log(emptyResults); // 輸出: []

備註

• 使用此函式會依賴 Google Maps 的網址結構與資料回應，若 Google Maps 網址格式或 HTML 結構變更，此函式可能需要調整。

• 若 addresses 不是陣列，或陣列中包含非字串的元素，可能導致函式行為異常。